---
title: oras repo tags
sidebar_position: 200
warning: Do NOT modify this generated file
---

# oras repo tags

Show tags of the target repository

```bash
oras repo tags [flags] <name>
```

## Examples

Show tags of the target repository:

```bash
oras repo tags localhost:5000/hello
```

Show tags in the target repository with digest-like tags hidden:

```bash
oras repo tags --exclude-digest-tags localhost:5000/hello
```

Show tags of the target repository that include values lexically after last:

```bash
oras repo tags --last "last_tag" localhost:5000/hello
```

Show tags of the target OCI image layout folder 'layout-dir':

```bash
oras repo tags --oci-layout layout-dir
```

Show tags of the target OCI layout archive 'layout.tar':

```bash
oras repo tags --oci-layout layout.tar
```

[Experimental] Show tags associated with a particular tagged resource:

```bash
oras repo tags localhost:5000/hello:latest
```

[Experimental] Show tags associated with a digest:

```bash
oras repo tags localhost:5000/hello@sha256:c551125a624189cece9135981621f3f3144564ddabe14b523507bf74c2281d9b
```

[Experimental] Show tags of the target repository in JSON format:

```bash
oras repo tags localhost:5000/hello --format json
```

[Experimental] Show tags of the target repository using the given Go template:

```bash
oras repo tags localhost:5000/hello --format go-template --template "{{.tags}}"
```

[Experimental] Show tags of a specific repository in OCI layout:

```bash
oras repo tags --oci-layout-path layout-dir localhost:5000/hello
```

## Options

```
      --ca-file string                             server certificate authority file for the remote registry
      --cert-file string                           client certificate file for the remote registry
  -d, --debug                                      output debug logs (implies --no-tty)
      --exclude-digest-tags                        [Preview] exclude all digest-like tags such as 'sha256-aaaa...'
      --format string                              [Experimental] format output using a custom template:
                                                   'json':         Print in JSON format
                                                   'go-template':  Print output using the given Go template
                                                   'text':         Print in text format (default "text")
  -H, --header stringArray                         add custom headers to requests
  -h, --help                                       help for tags
      --identity-token string                      registry identity token
      --identity-token-stdin                       read identity token from stdin
      --insecure                                   allow connections to SSL registry without certs
      --key-file string                            client private key file for the remote registry
      --last last                                  start after the tag specified by last
      --oci-layout                                 set target as an OCI image layout
      --oci-layout-path string                     [Experimental] set the path for the OCI image layout target
  -p, --password string                            registry password or identity token
      --password-stdin                             read password from stdin
      --plain-http                                 allow insecure connections to registry without SSL check
      --registry-config path                       path of the authentication file for registry
      --resolve host:port:address[:address_port]   customized DNS for registry, formatted in host:port:address[:address_port]
      --template string                            [Experimental] template string used to format output
  -u, --username string                            registry username
```
